Skip to content

feat: remove Atlatl MCP dependency, file-only persistence (v0.6.0)#5

Merged
zircote merged 2 commits intomainfrom
feature/methodology-enforcement
Apr 11, 2026
Merged

feat: remove Atlatl MCP dependency, file-only persistence (v0.6.0)#5
zircote merged 2 commits intomainfrom
feature/methodology-enforcement

Conversation

@zircote
Copy link
Copy Markdown
Owner

@zircote zircote commented Apr 11, 2026

Summary

  • Remove all Atlatl MCP dependency (blackboard, memory capture/recall/enrich) across 55 files — 491 occurrences eliminated
  • JSON file persistence in reports/{topic_slug}/ is now the sole data model; inter-agent coordination uses TaskUpdate and SendMessage exclusively
  • Version bump 0.5.1 → 0.6.0

Changes

Removed

  • mcp__atlatl__* tools from all 4 agents, 6 operational skills, 8 commands
  • Blackboard read/write/alert/create calls, null-guard fallback patterns, dual-write protocol
  • auto_atlatl and atlatl_memory_id config fields from schema, config examples, migration logic, docs
  • 62 Atlatl-specific eval test cases across 7 eval files (all remaining evals validated)
  • Architecture docs rewritten for file-based coordination model

Improved (via autoresearch)

  • skills/augment: Added --methodology as documented alias for --dimension
  • skills/report: Input validation, format-specific output, timeout handling, graceful cleanup
  • skills/issues: Input validation, cowork fallback, categorized error responses, regression guard eval
  • skills/migrate: Backup-before-write ordering, dual-format parsing, error handling

Test Plan

  • grep -ri "atlatl\|blackboard\|capture_memory\|recall_memories\|enrich_memory" . returns only CHANGELOG.md (documenting removal) and issues regression guard eval (checks for absence)
  • All 6 edited skills pass autoresearch eval loops (start: 1.0, update: 1.0, augment: 0.9375→1.0, report: 1.0, issues: 1.0, migrate: 1.0)
  • All eval JSON files validate as proper JSON
  • plugin.json has mcp_servers: ["github"] only, no atlatl in optional_dependencies

Remove all Atlatl blackboard, memory capture/recall/enrich references
across 55 files (491 occurrences). JSON file persistence in
reports/{topic_slug}/ is now the sole data model.

- Remove mcp__atlatl__* tools from all agents, skills, commands
- Remove blackboard read/write/alert/create calls and fallback patterns
- Remove auto_atlatl and atlatl_memory_id config fields and schema rules
- Remove 62 Atlatl-specific eval test cases across 7 eval files
- Rewrite architecture docs for file-based coordination model
- Clean up pre-existing autoresearch workspace artifacts
- Autoresearch improvements: augment (--methodology alias), report
  (validation, timeout, cleanup), issues (input validation, error
  categorization, regression guard), migrate (backup ordering,
  dual-format parsing, error handling)
- Bump version 0.5.1 -> 0.6.0
@zircote zircote marked this pull request as ready for review April 11, 2026 16:18
Copilot AI review requested due to automatic review settings April 11, 2026 16:18
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Removes the Atlatl MCP dependency throughout the plugin and standardizes on file-based persistence/coordination, with updated skills/docs/evals to match the new architecture and a version bump to v0.6.0.

Changes:

  • Eliminates mcp__atlatl__* tool usage and blackboard/memory patterns across agents, skills, commands, and docs.
  • Updates operational skills (notably report/issues/migrate/augment) for file-first coordination, stronger input validation, and improved failure/cleanup behavior.
  • Prunes Atlatl-specific eval cases and updates schemas/config examples; bumps plugin version to 0.6.0.

Reviewed changes

Copilot reviewed 70 out of 80 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
skills/update/SKILL.md Removes Atlatl tools/blackboard steps from update orchestration docs
skills/trend-modeling/SKILL.md Removes blackboard-key hint from orchestration hints
skills/trend-analysis/SKILL.md Removes blackboard-key hint from orchestration hints
skills/trend-analysis-autoresearch/iteration-0/eval-trend-tables/outputs/.gitkeep Keeps eval outputs directory placeholder
skills/trend-analysis-autoresearch/iteration-0/eval-trend-tables/grading.json Removes Atlatl-era autoresearch eval grading file
skills/trend-analysis-autoresearch/iteration-0/eval-mermaid-scenario/outputs/.gitkeep Keeps eval outputs directory placeholder
skills/trend-analysis-autoresearch/iteration-0/eval-mermaid-scenario/grading.json Removes Atlatl-era autoresearch eval grading file
skills/trend-analysis-autoresearch/evals.json Removes trend-analysis-autoresearch eval manifest
skills/tech-assessment/SKILL.md Removes blackboard-key hint from orchestration hints
skills/start/SKILL.md Removes Atlatl tools and blackboard init language from start launcher
skills/start-autoresearch/iteration-0/eval-methodology-loading/outputs/.gitkeep Keeps eval outputs directory placeholder
skills/start-autoresearch/iteration-0/eval-methodology-loading/grading.json Removes Atlatl-era start autoresearch eval grading file
skills/start-autoresearch/iteration-0/eval-methodology-gate/outputs/.gitkeep Keeps eval outputs directory placeholder
skills/start-autoresearch/iteration-0/eval-methodology-gate/grading.json Removes Atlatl-era start autoresearch eval grading file
skills/start-autoresearch/iteration-0/eval-dimension-selection/outputs/.gitkeep Keeps eval outputs directory placeholder
skills/start-autoresearch/iteration-0/eval-dimension-selection/grading.json Removes Atlatl-era start autoresearch eval grading file
skills/start-autoresearch/evals.json Removes start-autoresearch eval manifest
skills/report/SKILL.md Shifts report generation to state.json-only input, adds arg validation/timeout/cleanup guidance
skills/report/evals/evals.json Adds eval coverage for sections validation, corrupted state handling, and format “both”
skills/report-writing/SKILL.md Removes blackboard-key note from synthesis skill hints
skills/report-autoresearch/iteration-0/eval-swot-mermaid/outputs/.gitkeep Keeps eval outputs directory placeholder
skills/report-autoresearch/iteration-0/eval-swot-mermaid/grading.json Removes report autoresearch eval grading file
skills/report-autoresearch/iteration-0/eval-positioning-map/outputs/.gitkeep Keeps eval outputs directory placeholder
skills/report-autoresearch/iteration-0/eval-positioning-map/grading.json Removes report autoresearch eval grading file
skills/report-autoresearch/iteration-0/eval-html-format/outputs/.gitkeep Keeps eval outputs directory placeholder
skills/report-autoresearch/iteration-0/eval-html-format/grading.json Removes report autoresearch eval grading file
skills/report-autoresearch/iteration-0/eval-audience-executive/outputs/.gitkeep Keeps eval outputs directory placeholder
skills/report-autoresearch/iteration-0/eval-audience-executive/grading.json Removes report autoresearch eval grading file
skills/report-autoresearch/iteration-0/eval-9-section-report/outputs/.gitkeep Keeps eval outputs directory placeholder
skills/report-autoresearch/iteration-0/eval-9-section-report/grading.json Removes report autoresearch eval grading file
skills/report-autoresearch/evals.json Removes report-autoresearch eval manifest
skills/regulatory-review/SKILL.md Removes blackboard-key hint from orchestration hints
skills/migrate/SKILL.md Updates migration flow: dual-format parsing, backup-before-write ordering, schema-validation fallback, gitignore update
skills/migrate/evals/evals.json Expands migrate evals for backups, preservation of key values, dry-run messaging, malformed JSON, and merge prompts
skills/market-sizing/SKILL.md Removes blackboard-key hint from orchestration hints
skills/issues/SKILL.md Removes Atlatl tools and improves input validation/error categorization/cowork fallback guidance
skills/issues/evals/evals.json Adds regression guard eval asserting no Atlatl/blackboard references remain
skills/financial-analysis/SKILL.md Removes blackboard-key hint from orchestration hints
skills/customer-research/SKILL.md Removes blackboard-key hint from orchestration hints
skills/competitive-analysis/SKILL.md Removes blackboard-key hint from orchestration hints
skills/augment/SKILL.md Removes memory/blackboard flows; adds --methodology alias and file-only findings handling
SECURITY.md Removes Atlatl memory mention from threat surface summary
schemas/sigint-config.jq Removes auto_atlatl and atlatl_memory_id validation requirements
README.md Updates feature/agent descriptions to task + file-based coordination; removes Atlatl feature/config example
protocols/STRUCTURED-DATA.md Removes blackboard/dual-write guidance; clarifies file-first write/validate
hooks/hooks.json Removes Atlatl memory note from prompt hook
evals/orchestration/evals.json Removes blackboard/Atlatl-specific orchestration evals; keeps parallel spawn checks
evals/integration/evals.json Removes Atlatl-based integration evals and updates remaining expectations formatting
evals/commands/evals.json Removes Atlatl/Subcog transition tests; updates command eval expectations accordingly
evals/agents/research-orchestrator/evals.json Removes blackboard/Atlatl orchestrator evals; keeps batching/state.json expectations
evals/agents/report-synthesizer/evals.json Removes blackboard/Atlatl integration evals; keeps core output expectations
evals/agents/issue-architect/evals.json Removes Atlatl integration eval; keeps issue-quality expectations
evals/agents/dimension-analyst/evals.json Removes blackboard/Atlatl gating tests; retains large-source delegation/format checks
docs/tutorials/getting-started.md Removes optional Atlatl prerequisite from tutorial
docs/reference/skills.md Updates orchestration hints terminology to findings file keys
docs/reference/protocols.md Removes blackboard/dual-write references from protocol reference
docs/reference/configuration.md Removes auto_atlatl field from config reference and examples
docs/reference/commands.md Removes Atlatl tool listings; updates command behaviors (report/status/init/resume) for file-only model
docs/reference/agents.md Removes Atlatl tool listings; updates mappings to findings files and file-based persistence
docs/README.md Updates architecture link description to remove blackboard/memory wording
docs/how-to/troubleshooting.md Removes Atlatl/blackboard troubleshooting; reframes status issues around files/session state
docs/how-to/research-workflow.md Updates resume description to file-only restoration
docs/how-to/migrate-config.md Updates migrate steps to remove auto_atlatl migration mention
docs/how-to/deploy-to-cowork.md Removes Atlatl connector instructions and blackboard fallback troubleshooting
docs/how-to/configure-plugin.md Removes Atlatl-related config fields/topic metadata fields from examples and docs
docs/explanation/architecture.md Rewrites coordination section for file-based state and task messaging; removes blackboard/Atlatl sections
commands/update.md Removes Atlatl tools from allowed-tools list
commands/status.md Removes blackboard_read/Atlatl tool usage and associated logic
commands/start.md Removes Atlatl tools from allowed-tools list
commands/resume.md Removes Atlatl tools and updates listing table columns/behavior
commands/report.md Removes Atlatl tools from allowed-tools list
commands/issues.md Removes Atlatl tools from allowed-tools list; retains GitHub MCP tools
commands/init.md Reframes init away from Atlatl recall; updates config template example accordingly
commands/augment.md Removes Atlatl tools from allowed-tools list
CHANGELOG.md Adds v0.6.0 entry documenting Atlatl removal and related improvements; updates prior notes accordingly
agents/research-orchestrator.md Removes blackboard/memory tool usage; shifts Phase 0 to directory init and file-only flows
agents/report-synthesizer.md Removes blackboard/memory steps; reads dimension findings files only
agents/issue-architect.md Removes Atlatl recall/capture steps; focuses on file-based context + GitHub issue creation
agents/dimension-analyst.md Removes blackboard/memory steps; writes findings/conflicts to reports directory and signals via tasks/messages
.claude-plugin/plugin.json Bumps version to 0.6.0; removes atlatl MCP server and optional dependency

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread skills/report/SKILL.md
Comment thread skills/migrate/SKILL.md Outdated
- Allow status "complete" in report state.json validation (not just "active")
- Remove Edit tool from migrate skill, use Bash/sed per project convention
@zircote zircote merged commit e00f7bd into main Apr 11, 2026
1 check passed
@zircote zircote deleted the feature/methodology-enforcement branch April 11, 2026 16:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants